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1. Introduction 

This manual has two main sections: the Tutorial, and the 
Reference Guide. 

Please take time to read the Tutorial, as it introduces many of the 
terms used in reference to MAGICALC, and points out concepts 
that might not be immediately apparent. 

The Tutorial is a begimier's introduction to MAGICALC 
"automated calculator" system. It will teach you the basics and 
get you started using MAGICALC. The Tutorial will not teach 
you all there is to know about MAGICALC; for more informa- 
tion, commands and features of the system, see the Reference 
Guide section. 

To get the most out of the Tutorial, you should read it while sit- 
ting at your computer, rumiing MAGICALC, and actually carry- 
ing out the step-by-step instructions given in the manual. The on- 
ly way to learn MAGICALC is by "hands-on" experience! 

As you work throu^ the Tutorial, try to resist the temptation (at 
least at first) to depart from the instructions and experiment on 
your own. Stick closely to the instructions, to maintain the con- 
tinuity of the lesson. Later, after you've acquired a bit of profi- 
ciency with MAGICALC, by all means feel free to go off and ex- 
periment—it's the best way to learn! 

By the time you finish the Tutorial, you'U know enough about 
MAGICALC to begin building your own models for your own 
particular applications. You can then learn more from the 
MAGICALC Reference Guide. The Reference Guide is a concise 
summary of all aspects of MAGICALC. 

Inside the back cover there is a Reference Card which you can 
remove and keep by your computer for quick reference. 

With a little practice, you'll be able to use MAGICALC to put 
your Apple ][ (or Apple He) to work for you in a wide variety of 
useful ways. 
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MAGICALC is a program that turns your Apple ][ compute into 
an "automated calculator." With it you can create, manipulate, 
modify, and print reports covering a wide variety of calculations, 
such as: 

• Financial statements 

• Budgets 

• Cost estimates 

• Sales forecasts 

• Staffing plans 

• Development and product schedules 
and many, many more. 

MAGICALC provides you with a spacious "electronic 
worksheet" of 254 rows and 63 columns— a total of 16,002 cells 
for information storage. Your video screen becomes a "window" 
that you can slide up, down, left, or right over the worksheet. 

One of the exciting features of MAGICALC is that it allows you 
to play "what if...?" with your data. What if interest rates rise 
two points? How will that affect the data for future years? What 
if sales increase by five percent? In the blink of an eye, 
MAGICALC will recalculate all of your data and show you the 
results of your "what if . . .?" assumptions. You can then save the 
new data on a floppy diskette, print them, or both. 

This manual will show you, step by step, how to create a simple 
business financial forecast model like the one shown in Figure 1. 
After you have built this model on your screen, you'll learn how 
to play "what if...?" by changing some of the data and letting 
MAGICALC instantly calculate tiie effects of those changes. 
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PROGRAM DOCUMENTATION 
PLANNING MODEL 

TASK HOURS RATE COST 



RESEARCH 

FIRST PASS 

EDITING 

REWRITING 

TYPESETTING 

PRINTING 



65 
112 
56 
68 
52 



24.48 
24.48 
24.48 
24.48 
19.00 



1591.20 
2741.76 
1370.88 
1664.64 
988.00 
10547.00 



TOTAL 353 18903.48 

Figure 1. The Demonstration Model 
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2. APPLE )[ BASICS 

This section covers some of the basic things you need to know 
about your Apple ][ conqmter in order to run MAGICALC. If 
you're an experienced Apple user, you already know how to set 
up your computer, how to use the keyboard, and how to handle 
floppy diskettes: just read the following subsectacm, titled 
WHAT YOU WILL NEED, then skip ahead a few pages to 
STARTING MAGICALC. 



2.1. What You Wm Need 

In order to run MAGICALC, you will need the following: 

• An Apple ][, Apple ][ Plus, or Apple //e computer, with 48 
kilobytes ("48K") minimum memory, but preferably with one 
or more RAM cards. 

• A closed-circuit video (TV) monitor and connecting cable. 

• One or more disk drives, with controller cards set up to read 
16-sector "floppy" diskettes. 

Note: Instead of a closed-circuit monitor, you can use an ordinary 
home TV, along with a radio-frequency (RF) modulator. 
The dealer who sold you your Apple ][ can provide you with 
an RF modulator and show you how to connect it. Connect- 
ing your TV set to jrour Apple computer won't harm the 
TV in any way. 

Although MAGICALC only displays information on the screen 
in black-and-white, a coltn- monitcn' TV set will also work. In 
general, you will get a clearer display with a black-and-white than 
with a color imit, and a monitor wiU give better results than a TV 
set with modulatXB'. A screen size of 12 inches is recommended, 
but a 9-inch sa«en will also give acc^table results. 

Note: MAGICALC wiU not run on a disk drive that is configured 
for 13-sector diskettes. If you have the Apple Language 
System, or version 3.3 or lata: of the Apple Disk Operating 
System (DOS), then you are ia'^>erly equipped to run 
MAGICALC. If you have an earlier version of DOS and no 
Language System, you will probably need to upgrade your 
disk controllers from 13- to 16-sector operation. See your 
Apple ctealer for ftuther information. 
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The following optional equipment will add to MAGICALC's 
usefulness: 

• A RAM card. MAGICALC supports all language-card com- 
patible RAM cards in various combinations up to 512K (four 
128K RAM cards). The usable portion of your worksheet will 
be expanded by the addition of one or more RAM cards. 

• A iffintOT will enabfe you to print pernianent "hard copies" of 
your MAGICALC models. 

In addition, you'll need the MAGICALC program diskette that 
came with this manual, and a blank diskette to use for storing the 
models you create. 

2.2. Setting up your Apple Computer 

If you've just unpacked your Apple ][ computer, here's how to set 
it up to run MAGICALC: 

1. Connect one end of the computer's power cord to the power 
coimector at the left rear of the computer, and plug the other 
end into a grounded (3-prong) power outlet. 

2. Plug in the video monitor and coimect it to the jack marked 
VIDEO OUT on the back of the computer with the proper 
connecting cable. (If you're using an ordinary TV set with an 
RF modulator, follow the installation instructions that came 
with the modulator.) 

3. If you have a RAM card, follow the installation instructions 
supplied by the manufacturer (note: MAGICALC will find 
your RAM card in whichever slot you place it, but the stan- 
dard slot for RAM cards is 0). 

4. Install the disk drive(s), following the instructions given in 
Chapter 1 of the Apple Disk Operating System (DOS) 
Manual that came witii the disk drive(s), or the instructions 
provided by the manufacturer. 

5. If you have a printer, connect it to the computer by following 
the instructions given in the printer manual and the interface 
card manual. 
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Note: The customary slot for printer interface cards is 1, and 
that is what MAGICALC ordinarily expects. You may, 
however, configure MAGICALC to recognize your 
printer in any slot except (see Configuration Sub- 
system discussion in the Reference Guide for details). 

Note: The customary slot for 80 column video boards is 3, 
however MAGICALC does not look for an 80 column 
board unless you so specify (see Configuration Sub- 
system discussion in the Reference Guide for details). 80 
column boards will not be recognized in slot 0. 

When you've completed these installation steps, your computer 
is ready to run MAGICALC. 

2.3 The Apple ][ Keyboard 

The Apple ][ keyboard is similar to an ordinary t3T)ewriter 
keyboard, but it has a few peculiarities that you should know 
about. 

First, the Apple ][ keyboard contains uppercase (capital) letters 
only. Most letter keys produce the same character, whether you 
hold the SHIFT key down or not; the SHIFT key applies only to 
those keys with two different characters on them. To produce the 
lower of the two characters, just press the key all by itself; to pro- 
duce the upper character, press the key while hdding down the 
SHIFT key at the same time. 

Note: EXCEPTION: When the SHIFT key is held down, the 
M key produces a right bracket character (]) instead of a 
letter M, even though the right bracket is not shown on 
the keycap. 

Note: This action of pressing and holding down one key while 
typing another is called a combination keystroke. We 
will use a notation such as SHIFT— M to represent the 
combination keystroke with the SHIFT and M keys 
described in the preceding paragraph. 
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The Apple ][ keyboard also contains a few special keys not found 
on an ordinary tyjjewriter. One of the most important of these is 
marked CTRL, which stands for ConTRoL. This key is used to 
type special control characters that tell the computer what you 
want it to do. These control characters have no graphical 
representation, and cannot be displayed on the screen or printed 
on paper. To type one, you use the Ctrl key in the same way as the 
SHIFT key: press Ctrl and hold it down while typing some other 
character. Such a combination keystroke with the Ctrl and A 
keys would be represented by the notation Ctrl— A. 

The key marked REPT (for REPeaT), when held down along with 
any other key, causes that other key to be repeated over and over 
again, at high speed, for as long as you hold down both keys. A 
combination keystroke with the REPT and Right Arrow keys is 
represented by the notation REPT-Right Arrow. 

The RETURN key on the Apple ][ keyboard corresponds to the 
carriage return on a typewriter. On a typewriter this key is used 
to end a line by returning the carriage to the beginning of the 
next line. As you'll see, the RETURN key on the Apple ][ is used 
for a similar end-of-line function in MAGICALC, 

The ESC (ESCape) key and those marked with left- and right- 
pointing arrows have special uses in MAGICALC, which you will 
learn about in due course. When you're running MAGICALC, the 
key marked RESET has no effect at all, and you should never 
have occasion to press it. 

Note: If your Apple ][ is not equipped with the Autostart ROM 
feature, you will need to use the RESET key as part of 
the standard startup jMwedure— see STARTING 
MAGICALC, below, for details. 

Note: The white square marked POWER at the lower left of 
the Apple ][ keyboard is an indicator light that lights 
when the computer's power is on. It is not a kegr, and 
there is no way to press it. (The power switch is located 
on the back of the computer.) 
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2,4. For Apple lie Users 

Most of the preceding discussion on the Apple ][ keyboard will ap- 
ply to you, but your keyboard does generate a true upper and 
lower case, and all the special characters are available directly 
from the keyboard. In addition, there are several special keys 
that MAGICALC can take advanta^ of on the Apple //e: 

The Up Arrow 
The Down Arrow 
The DELETE key 
The TAB key 

The "Open Apple" key (the key with the Apple symbol on it 
that is not filled in). 

All of these keys, and their functions will be discussed in greater 
detail later. 



2.5. Handling INskettes 

With one or more disk drives, your Apple ][ has the ability to 
store and retrieve information on 5V4 inch "floppy" diskettes. 
Each diskette is a mass-storage medium with a capacity of 143 
kilobytes ("143K") of information. (They're called "floppy disk- 
ettes because they're made of flexible plastic, to distinguish them 
from harder "rigid" disks.) 

Diskettes are a very convenient way of storing information, but 
they have to be handled with respect. They're sensitive to heat, 
dust, smoke, scratches, fingerprints, and magnetic fields. Each 
diskette comes sealed in its own black jacket. You should never 
take a diskette out of its jacket, bend it (much less fold, spindle, 
staple, or otherwise mutilate!), or touch its surface through any of 
the holes in the jacket. Never write on a diskette label (once the 
label is attached to the diskette) with anjrthing but a felt-tip 
pen— and don't press too hard! See Chapter 1 of your Apple Disk 
Operating System (DOS) Manual for further tips on the proper 
care and handling of diskettes. 
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3. STARTING MAGICALC 

Once you have all the necessary equipment installed and con- 
nected properly, you're ready to start up MAGICALC. 

To start MAGICALC: 

1. Turn on your video monitor. 

2. Open the door to the main disk drive. (The main drive is drive 
1 in the highest-numbered peripheral slot containing a disk 
controller card. By convention, this is slot 6.) 

3. Carefully insert your MAGICALC diskette into the disk 
drive, with the label nearest you and facing up, and push it 
gently into the disk drive as far as it will go. (If you hold the 
diskette with yoiir thumb on the label, you wiU have it facing 
properly.) 

4. Gently close the disk drive door. 

5. Turn on your Apple ][ computer. (The power switch is a small 
"rocker switch" located on the back of the computer, n^ the 
left side.) 

The computer wiU issue a short beep, the red Hght labeled IN 
USE on the front of the disk drive will come on, and the disk 
drive wiU begin making whirring and chattering noises. (Don't be 
concerned by these noises — they are perfectly normal.) In about 
5 to 10 seconds the IN USE light will go off, and the noises will 
subside. 

NOTE: If your Apple ][ is not equipped with the Autostart ROM 
feature, it will simply beep when you turn on the power 
and display an asterisk {*) near the bottom of the screen, 
followed by a blinking white box called the cursor. 

To start up MAGICALC, you must now press the 
RESET key, type the number of the peripheral slot to 
which the main disk drive is connected (usually 6), then 
type the combination keystroke Ctrl- P. (Hold down the 
Ctri key while typing the letter P.) Press RETURN. The 
disk drive should then start up, as described above. 
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6. The message: LOADING will fij^jeffi" oh yom mmm, then a 
title page. At the bottom of the title page will be the prompt: 

INSERT t50NF)<3URATION/DRIVER DISKETTE 
< RETURN > OR ,S,D,V 

What you are being prompted to do is to place the diskette 
with the configuration options for your system in your disk 
drive, then press the key marked RETURN. The configura- 
tion and driver options will be discussed in the Reference 
Guide. For our purposes, we can use the supplied configura- 
tion, so just press RETURN. 

7. After the IN USE light goes off, open the door again, careful- 
ly remove your program diskette, and put it away in a safe 
place. 
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4. THE SYSTEM MENU 

If all has gone well, your screen should look more or less like 
figure 2. Let's take a moment to examine MAGICALC Syst«n 
Menu before going on into the Calculate Subsystem. 




2. FILE SUBSYSTEM 

3. PRINT SUBSYSTEM 

4. FORMAT SUBSYSTEM 

5. CONFIGURATION SUBSYSTEM 

6. BOOT NEXT PROGRAM 



SELECT NUMBER OR LETTER. PRESS RETURN 



Notice the use of the word subsystem in the menu. MAGICALC 
is a system comprised of several smaller systems, or subsystems. 
You wiU spend most of your time using the Calculate Subsystem, 
which will often be referred to as calculate mode, to distinguish it 
from menu mode. You will also need the File, Print, Format, and 
Configuration subsystems to do everything you want. 

Notice that menu item 1 —Calculate Subsystem is marked with a 
highlight bar. You may move about hi the menu, or press the 
RETURN key to accept the selection marked by this highlight 
bar. Press the RETURN key now to enter the Calculate Sub- 
system. 
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5. THE WORKSHEET DISPLAY 




Let's spend a few minutes looking at the various parts of the 
worksheet display and the information they contain. 

5.1. The Infonnation Box 

At the very t<^ of the screen is a region, two lines high, called the 
information box. MAGICALC uses this region to keep you in- 
formed about where you are and what you can do next. 



5.2. Hie Contents line 

The first line of the information box is called the contents line. It 
tells you which cell of the worksheet is the current cell (more on 
the current cell in a little while) and what that cell contains. Bight 
now the contents line should be displaying the coordinate Al at 
the extreme left; the rest of the line is blank, since you've just 
started up and every cell of the worksheet (including cell Al) is 
empty. 
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5.3. The Prompt Line 

Directly below the contents line is the prompt line. The prompt 
line is displayed as a white line, and the characters will appear in 
black. Thi3 line tells you what your options are from moment to 
moment. It is called the prompt line because MAGICALC uses it 
to "prompt" you about what you can do next. Right now the 
prompt line should be blank since you've just started. 



5.4. The Memory Indicator 

The number at the left end of the prompt Hne is the memory in- 
dicator. It teUs you how much space is left in the computer's 
memory for storing information on the worksheet. If your Apple 
][ is equipped with a RAM card, this number should be 30; if not, 
the number should be 14. This means that right now you have 30 
or (14) kilobytes of memory available. (One kilobyte is equivalent 
to about 1000 characters of information). 

NOTE: As you fill up the worksheet, the number displayed in 
the memory indicator will get smaller. If it ever falls to 
zero, the computer's memory is full and there is no room 
to enter any more information on the worksheet. If this 
should happen, MAGICALC will display an error 
message informing you of the problem. 



5.5. The Entry Line 

Directly below the white prompt line is a black line called the 
entry line. This hne is like a temporary storage area for informa- 
tion you wish to place on the worksheet. Any information you 
type from the keyboard will appear on the entry line. If you wish, 
you can change, or edit the contents of the entry line at any time 
(to correct typing mistakes, for example). Then, when you're 
satisfied the information is correct, you enter it into the 
worksheet, usually by pressing the RETURN key. 
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5.6. The Worksheet Window 

Along the left edge of the screen is a vertical white column con- 
taining the numbers from 1 to 20. Above the column of numbers 
is a white horizontal stripe containing the letters A to E. These 
white borders mark the boundaries of your window into the 
worksheet. Each number on the left marks a row of the 
worksheet, and each letter at the top marks a column. Right 
now, twenty rows and five columns are visible in your 
worksheet window. The combination of a column letter and a 
row number (for example Al or C17) is called a coordinate, and 
identifies a cell of the worksheet. 

On the very left of the horizontal window border (containing the 
column letters), are three characters in a black box. These 
characters indicate various status information. 

The leftmost of these is the recalculation order indicator. It will 
either be a C or an R. This indicates whether your worksheet will 
be recalculated column by column, or row by row. Recalculation 
will be discussed in greater detail in the Reference Guide. 

The middle character is the recalculation mode indicator. It will 
either be an A or an M. This indicates whether recalculation will 
take place automatically whenever a new value is entered, or 
manually (upon request). 

The rightmost of the three status characters is the direction in- 
dictator. It will either be a— or a !. This character indicates the 
direction the marker wiU move if an arrow key is pressed. This 
will often be referred to as the marker direction. If the direction 
indicator is a — , and an arrow key is pressed, the marker will 
move horizontally across the worksheet. If the direction indicator 
is a !, and an arrow key is pressed, the marker will move vertically 
within the worksheet. 

Note: If you have an Apple/M the direction indicator makes 
no difference to you, as you have the special up and 
down arrows available on the keyboard, and 
MAGICALC automatically knows that they are there. 
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Note: For the purposes of this tutorial we will be wofking in 
40 columns. Later on, if you wish to switch to 
MAGICALC's 70 coiumn display, or if you have an 80 
column display board, you may do so. 



5.7. The CiUTent Cell Marker 

You can enter information into only one cell of the worksheet at a 
time. This cell is called the current cell. The current cell is marked 
by a white rectangle called the current cell marker (or simply the 
marker, which you should now see on on your screen at coor- 
dinate Al. The coordinate of the current ceD (in this case, Al) is 
always displayed in the current cell indicator on the contents line, 
in the top-left comer of the screen. 



15 



MAGICALC Tutorial— Beep! 



6. BEEP ! 

Everybody makes mistakes. Sooner or later, as you use 
MAGICALC, you'll make some kind of procedural error, and the 
computer will "beep" at you. That's a signal that whatever 
you've just typed doesn't make sense to MAGICALC. In most 
cases you can correct the «Tor simply by trying again. If this 
causes another beep, go back and reread the instructions for 
whatever you were trying to do, see what you did wrong, ihsa do 
it again the right way. 

Similarly, you may from time to time make typing errors while 
entering informatioa That kind of error is easy to fix: see the sec- 
tions of this manual titled CORRECTING TYPING ERRORS 
and EDITING A CELL for details. 



16 



MAGICALC Tutorial— Moving The Mai^w 



7. MOVING THE MARKER 

Before you can enter infomiation into a cell, you have to make 
that cell the current cell by moving the marker. 

The marker can be moved in two ways: with the arrow keys, and 
with combination keystroke control keys. Let's look at the arrow 
key technique. 

Press the right arrow key (on the right hand side of the keyboard). 
The marker should move to the right one space. Notice that the 
direction indicator is a dash ( — ), indicating horizontal movement. 

The current cell indicator should now show Bl (because you've 
moved the marker). 

Now press the space bar once. Notice that the direction indicator 
changes from a dash ( — ) to an exclamation point ( ! ). This in- 
dicates that your movement direction is vertical now. 

Press the right arrow key, and the marker will move down one 
cell to B2. Notice how the current cell indicator changes to reflect 
this move. 

Press the space bar, then the left arrow key, and you will move 
the marker to A2. 

Press the space bar, then the left arrow key, and you will move 
the marker back to Al — right where you began. 

If you now hit the left arrow key again, you'll hear a low-pitched 
tone, called a "thump." This is a signal that you've "bumped in- 
to the edge" of the worksheet and can go no further in that direc- 
tion. Notice that the marker doesn't move and the current cell 
(Al) doesn't change. 
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The alternate method of moving the marker is to use combination 
kejrstrokes. These keystrokes allow you four direction motion 

within the worksheet without having to press the space bar, and 
there are several special options available. Here are the keys: 

Ctrl— Q Move the marker up one. 

Ctrl— A Move the marker left one. 

Ctrl— S Move the marker right one. 

Ctrl— Z Move the marker down one. 

In order to activate one of these sequences, you must hold down 
the key marked Ctrl while simultaneously depressiiig the named 
letter. 

The additional options are: 

Ctrl— W Move the marker up half a screen. 

Ctrl— X Move the marker down half a screen. 

Ctrl— E Move the marker to the beginning of the worksheet. 

Ctrl— C Move the marker to the end of the worksheet. 

These marke- control cations are very useful in getting around in 
tiie worksheet quickly. 



18 



MAGICALC Tutorial— Slidii^ The Window 



8. SLIDING THE WINDOW 

The electronic worksheet is actually much bigger than your 
screen. Make certain the direction indicator is a dash (horizontal 
movement). Press the right arrow key four times, to move the 
marker to cell El at the right edge of the screen. Now press the 
right arrow once more, and watch the row of column letters 
across the top of the worksheet window. The letters will shift one 
column to the left, with A disappearing at the left end and F ap- 
pearing at the right. The worksheet window has slid one column 
to the right on the worksheet, pushing column A out of view and 
revealing column F which waisn't visible before. 

If you continue to press the right arrow key, the window will con- 
tinue to side to the right over the worksheet, bringing new col- 
umns into view. You can think of the marker as dragging the 
edge of the window along as it moves across the worksheet. Try 
pressing the left arrow five times to move the marker back to the 
left, and you'll see the window slide to the left along with it. You 
can also slide the window up or down in the same way (if the 
direction indicator is vertical). 
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9. HOW BIG IS THE WORKSHEET? 

Now start pressing the right arrow key repeatedly, to move the 
marker and the window to the right again. Keep going untU you 
reach the end of the alphabet. When you pass colunm Z, columns 
AA, AB, AC will appear. 

By this time you're probably getting tired of pressing the right 
arrow key. Try holding down both the right arrow and the KEPT 
(REPeaT) key at the same time. (We will use the notation 
REPT-Right Arrow for this kind of combination keystroke.) 
Holding down REPT along with any other key causes that other 
key to be repeated over and over again, at high speed. So in this 
case it sends a whole string of right arrows, for as long as you 
hold down both keys. This feature is particularly useful for 
long-range marker moves such as you're doing now. Continue to 
hold down REPT-Right Arrow untfl you start hearing '^thumps" 
signaling that you're bumping into the right edge of the 
worksheet. After column AZ comes BA, BB, and so on. When 
you reach the edge of the worksheet, you will see that the last col- 
umn is BK. Since K is the eleventh letter of the alphabet, this 
means that there are 52-1-11 = 63 columns altogether. 

Note: If you have an Apple //e, you wiU notice that the REPT key 
is missing. That is because all the keys are auto-repeating. 
That means that if you hold the key down for longer than a 
second, the computer will begin to generate the letter or 
number repeatedly. 

Now set the mariker directitm to vertical (by pressing the space 
bar). Press and hold down REPT-Right Arrow to move the 
marker repeatedly downward, and watch the column of row 
numbers at the left edge of the screen. When the marker reaches 
the bottom of the screen, the window will begin to slide 
downward over the worksheet, with old rows disappearing at the 
top and new rows coming into view at the bottom. Keep on 
holding down REPT-Right Arrow until you bump into the 
bottom edge of the worksheet. It takes quite a while, doesn't it? 
When you finally reach the bottom, you'll find that the last row 
on the worksheet is row 254. So altogether the worksheet con- 
tains 254 rows times 63 columns, or 16,002 cells. The current cell 
indicator at the beginning of the contents line should now read 
BK254, the ceE in the bottom-right comer of the worksheet. 
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Note: In 80 column mode, and sometimes in 40 column mode, the 
screen will not be able to keep up with repeating sequences. 
This does not mean that MAGICALC is ignoring you. On 
the contrary, it wiU be updating its marker location inter- 
nally, and will always update the uppermost row number 
(for vertical marker moves), and the leftmost colimin 
number (for horizontal marker moves). 
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10. JUMPING DIRECTLY TO A CELL 

Now that you have the marker in the bottom-right comer of the 
worksheet, how can you move it back to the top>-left, where you 
started? You could go back the same way you came, using 
REPT— Left Arrow to sKde the window up the worksheet, then 
pressing the space bar and continuing with REPT— Left Arrow 
to slide it to the left. But there's a quicker way to move the 
marker directly to any cell you wish. To jump directly to a cell: 

1. Tj^e the character >. (Hold down the SHIFT key and type a 
period.) 

The character > stands for the Go To command. The prompt 
message: 

GOTO: COORD 

will appear on the prompt line, and a small, blinking white box (or 
underline) wiU appear on the entry line. This blinking box is called 
the edit cursor (or simply the cursor) and means that 
MAGICALC is waiting for you to type something in on the entry 
line— in this case, the coorcUnate of the cell you wish to jump to. 

2. Type the coordinate of the cell you wish to jump to. 

Since you want to jump back to the top-left comer of the 
worksheet, type the coordinate Al. Notice that as you type each 
character, it appears on the entry line and the cursor moves one 
position to the rij^t to show where the next character will go. If 
you make a typing error, you can correct it as long as the cursor is 
still visible on the entry hne-see CORRECTING TYPING 
ERRORS, below. 

3. When the coordinate on the entry line is correct, press the 
RETURN key to complete the Go To command. The marker 
will immediately jump to the requested coordinate, which will 
also appear in the current cell indicator at the top of the 
screen, and you will be back in calculate mode. 
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11. SUMMARY OF MARKER MOVEMENTS 

You have now learned four ways to move the marker from one 
place to another on the worksheet: 

• With the right and left arrow keys, using the space bar to 
switch from horizontal to vertical movement. 

• With the Ctrl-Q, Ctrl- A, Ctrl-S, and Ctri-Z keys. 

• With KEPT— Right Arrow, and KEPT- Left Arrow for 
rapid marker movements. 

• Use the Go To command {type the character > to jump direct- 
ly to any desired cell. 

Take a few minutes to practice these four different ways of mov- 
ing the marker. Before long, you'll be able to move quickly to any 
cell you wish. 
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12 INFORMATION AND THE WORKSHEET 

Now you're ready to start entering information into the 
worksheet. Each individual cell of the worksheet can hold one 
single item of information, which may be either: 

• A value: a number, or a formula telling how to calculate a 
number. 

• A piece of text: a sequence of characters (letters, digits, 
spaces, punctuation, and so forth), not necessarily intended to 
represent a number or a formula. 

• A repeating label: a pattern of characters that are to be 
repeated as many times as necessary to fill the cell. 

You'll learn about each of these different types of information in 
the sections that follow. 

A cell can hold no more than one item of information at a time. 
When you enter new information into a cell, it replaces any 
previous information on the cell may have contained. It's a little 
like recording music on magnetic recording tape: the previous 
contents are permanently erased and cannot be recovered. 
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13. ENTERING TEXT INTO A CELL 

Let's begin building the demonstration model shown in Figure 1. 
The first thing we wiU want to enter is a set of column labels so 
we can keep our entries straight. 

The first column title begins in cell A4, so move the marker to A4 
using any of the methods described listed under SUMMARY OF 
MARKER MOVEMENTS. 

Now, simply type the word: 

TASK 

As you type the first character, three things happen: 

The word LABEL will appear in the prompt line. 

The character "T" wiU appear on the entry line. 

The character "T" will appear in cell A4 in the marker. 

As you continue to type characters, the letters continue to appear 
on the entry Une, the blinking cursor moves to the right, and the 
letters appear inside the marker in cell A4. 

To terminate the entry of this label, simply press RETURN, or 

one of the keys that move the marker. The entry will then be ac- 
cepted, and become part of your worksheet. Until you press one 
of these keys, the entry is available to be edited; that is, it is not 
yet permanent. 

For the purposes of this example, terminate the input with a 
Ctrl-S, or a right arrow key (if the marker direction is horizontal, 
as shown by a dash in the direction indicator square). 
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Now, type the labels: 

HOURS in ceU B4 
RATE in cell C4 
COST in ceU D4 

just as you typed TASK. 

You should now have all your column labds set up! That was 
easy, wasn't it? 

Why not tak6 off on your own for a moment and type in the row 
labds. Use the Ctrl-Z keystroke to enter these labels: 

RESEARCH in A5 

FIRST PASS in A6 

EDITING in A7 

REWRITING in A8 

TYPESETTING in A9 
PRINTING in AlO 

TOTAL in All 

If you are watching carefully, you will notice something strange 
happening when you enter the word RESEARCH. The entire 
word appears on the entry line, but in cell A6, where the marker is 
located, the word RESEARC appeara. 

MAGICALC remembers the entire label you type, but it displays 
only the number of letters it can fit in the column. 

The worksheet display that we now have is not quite what we 
want, but that is where one of the most powerful features of 
MAGICALC comes into play: variable column width. 

In many cases the row titles have to be longer than the amount of 

space required to display the numbers. It would be a shame, not 
to mention a waste of space, to set all the columns to a width 
large enough to accommodate the titles. 
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14. SETTING INDIVIDUAL COLUMN WIDTH 

In order to set the column width, you must have positioned the 
marker in that column. Position the marker in column A, if it is 
not already there using any of the marker movement commands 
discussed earlier. 

Now type: 

/ 

Do not hit a RETURN. You should see a new display on the pro- 
mpt line: 

/:ABCDEFGILMPRSTW — 

The slash (/) character signals MAGICALC that you are going to 
enter a command. What you see on the prompt line is the entire 
list of commands available at that point. 

Now type the letter L (again no RETURN key is necessary). The 
prompt line will change to read: 

COLUMN WIDTH: 0—36 D 

The longest title we wish to display is TYPESETTING, which is 
eleven letters long, so type 11, and press the RETURN key to 
enter the new column width. Notice how column A expands to 
eleven spaces, pushing all the other columns over. MAGICALC 
now can display all of your row titles in their entirety! 
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15. ENTERING A VALUE INTO A CELL 

Now, let's enter the values for the hours. 

Entry of values is nonidi the same as entry of labels. 

1. Move the marker to the desured cell (in this case B5). 

2. Type-the number you wish to enter. 

Type the number 65. Just as before, what you type will appear on 
the entry line, with the cursor advancing a character at a time as 
you type. As long as the cursor is still visible on the entry line, 
you can edit what you've typed to correct errors, or cancel the en- 
tire entry and restore the cell to its previous contents (see 
CORRECTING TYPING ERRORS, -below). 

4. When the informatian on the entry line is correct, press the 
RETURN key to enter the information into the current cell. 

When you press RETURN, the contents of the entry line (65) will 
be transferred to the current cell (B5), replacing any information 
the cell may have contained previously. The entry hne will be 
cleared, the edit cursor will disappear, and you will be returned to 

calculate mode. 

There is no way to recover what you had ia a cell after you have 
entered new data by pressing the RETURN or marker movem^t 
keys, so be sure you are not overwriting valuable data before 
pressing RETURN (or one of the marker movement keys). 

Notice that the contents line (the top line of the screen) has chang- 
ed to read: 

B5 V: 65 

This Une always shows you the contents of the current ceU. In 
this case, B6 is the coordinate of the current cell; the V: means 
that the cell contains a numerical value; and 65 is the value the 
cell contains. 
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Now enter the values for the rest of the items as follows 
(remember to tennimte each entry with a RETURN or a Ctrl-Zh 

FIRST PASS 112 

EDITING 56 

REWRITING 68 

TYPESETTING 52 

Do not enter anything for PRINTING. 
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16. CORRECTING TYPING ERRORS 

If you make a mistake while typing something on the entry line, 
all is not lost. Recall that the entry line is only a temporary 

storage area— the information you type there doesn't become 
final until you enter it into the worksheet, by pressing the 
RETURN or marker movement keys. As long as you have not 
pressed one of these keys, you can modify the entry or back out 
entirely. 

The simplest way to correct a typing error is to just back over the 
letters you typed in error, then retype the correct ones. This is 
where tiae special key marked ESC (for ESCape) comes into play. 

The ESC key is your backspace key. It also deletes the charactOTS 
it backs over, allowing you to enter them again correctly. 

Note: Apple //e users may use the DELETE key to delete 
backwards through an entry. 

Note: Using the ESC key to back the cursor all the way out of the 
begimiiiig of the ^try line will caned the entire entry and 
return you to calculate mode. 

Let's enter the first word of the title: PROGRAM DOCUMEN- 
TATION PLANNING MODEL, and get some practice using the 
ESC key to correct typc^raphical errors. 

First, move the marker to ceU Bl. Now, type: 

PRAGRAM 

Do not press the RETURN or marker movement keys. You will 
notice that there is an error in the speUing. In order to correct 
this, press the ESC key. Notice how the M disappears, and the 
blink^ cursor moves one space over to the left. 
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Continue pressing the ESC key until you have eraseil all die 
characters except the PR (press tiie ESC key lour more tunes). 

Now, type: 

OGRAM 

Snce what you now see on the entry line is correct, you may press 
the RETURN or marker movement keys to enter it. 
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17. IMMEDIATE CALCULATIONS 

Now, let's enter the values for rates. Say the employees doing the 
bulk of the work— research, first pass, editing, and rewriting are 
making $18.00 per hour, plus fringe benefits and office space con- 
siderations amounting to roughly 36% of their hourly salary. We 
can express the effective rate as 18.00 times 1.36. 

Move the marker to cell C5, using any of the marker movement 
keys, and type the formula: 

18*1.36 

Note: The asterisk (*) is MAGICALC's multiplication symbol. 

As when you entered the values for hours, the prompt hne will 
immediately display the word VALUE. 

If you were to press RETURN or a marker movement key, the 
formula would be entered as is, and the result of the formula 
would be placed in cell C5. This is not always desirable, as 
MAGICALC has to reevaluate all formulas every time it 
recalculates the worksheet. Since this number is relatively cons- 
tant, and has no dependencies on other cells, we can use im- 
mediate calculation to replace our formula on the entry line with 
the actual result. 

Press the exclamation point ( ! ), and the formula on the entry line 
will be replaced with 24.48. Now you may press RETURN or one 
of the marker movement keys to enter the data. 

Now enter the rest of the values for rate, either by typing them in 
directly, or by using the immediate calculation feature. 
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18. HINTS ON ENTERING TITLES 

Entering titles into MAGICALC is a very simple task, and will 
fael^ you identify the nature of the data in your various 

Using the title we began to enter in the previous sect&m, we now 
have the partial title: 

PROGRAM 

Notice that the word PROGRAM completely fills cdl Bl. We 

know from previous experience that if we were to continue typ- 
ing, the entry would be remembered, but only the amount that fit 
in the column would be disfdajred. 

This time, we will move over to the next column to omtanue the 
title, as expanding the column width would interfere with the col- 
umns of numbers below. 

Move the marker over to cell Cl. Note that the continuation of 
the title must begin with a space. We know that simply typing a 
space signifies to MAGICALC that we wish to change the 
matkra* movement direction. 

In order to start a label with a space, a number, or any character 
that has special significance to MAGICALC, we must first type a 
quote mark ("). To enter the continuation of our title, type the 
quote mark now (shift-2 on the Apple ][). 

The word LABEL should now appear on the prompt line. 

Now type a space, then the next word, DOCUMENTATION, 
watching what happens as you type each letter. 

When you reach the first N in DOCUMENTATION, you run out 
of room in the cell. You can teU this by watching the letters as 
they appear in the cell. This is a signal to you that it is time to 
move to the next cell. 

Using the ESC key, back up over the N, then enter the word 

DOCUME (with a space at the beginning) by pressing MITURN 
or one of the marker movement keys. 
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Move the marker to cdl Dl if it is not already there, and complete 
the first title line hy typing: 

NTATION. 

Now, move the marker to cell B2 and enter the title: 
PLANNING MODEL 

the same way as you entered the previoas line. 
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19. INSERTING AND DELETING 
ROWS AND COLUMNS 

We forgot to put in rows for the dashed lines. It would be a shame 
if we had to re-key all of our work just to rectify so small an error. 
We all change our minds about what we want to put in planning 
models, so MAGICALC has a fadUty for inserting and deleting 
rows and cohunns. 

To insert a row in the wcnrksheet. 

1. Move the marker to the row below where the new row is to go. 

In this case, since you're adding a new row above RESEARCH, 
you want the marka- positioned in row 5. 

2. Type tbe slash (/) key. You will recall that this key signals 
MAGICALC that you are about to enter a command. 

The prompt line will now read: 

/:ABCDEFGILMPRSTW — 

Indicating your possible choices. 

3. Press the I key, indicating that you want to insert. 
The prompt line will display the message 

INSERT: R( — )C(!) 

asking whether you wish to insert a row or a column. It might 
seem trivial, but it is not apparent to some people which are rows 
and which are columns. That is why the ( — ) and (!) are included 
in the prompt. Rows are horizontal ( — ), and columns are vertical 
( ! ). You should be familiar with this convention from the marker 
direction indicator. 

4. Type R (for Row). 

A new, empty row will appear at the marker position; the row 
containing the marker, and everything below it, will be shifted 
down one place to make room, and you will be returned to the 
calculate mode. 
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Note: In the future, we will not spell out the commands in such 
detail— we will simply say, for example: 

T^pe /IR to insert a row. This stands for: 

• conunand 

• insert 

• row 

Now, type / IR (Insert Row) five more times, so that you have six 
blank rows between TASK and RESEARCH. Note how the row 
containing the word RESEARCH moves down each time. 

Inserting a column in the worksheet is virtually the same. Simply 
follow this procedure: 

1. Move the marko- to the column wh^ the new column is to 
go. 

2. Type II (for Insert). 

As before, the prompt line will display the message 
INSERT: R( — )C(!) 

asking whether you wish to insert a row or a column. 

3. Type C (for Column). 

A new, empty column will appear at the marker position; the col- 
umn containing the marker, and everything to the right of it, will 
be shifted one place to the right to make room; and you will be 
returned to calculate mode. 

It's just as e&sy to delete a row or a coilumn from the worksheet 
as it is to add one. Let's delete one of the extra rows you just add- 
ed at the top of the worksheet. 
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To delete a row or column from the worksheet: 

1. Move the marker to the row or column you wish to delete. 
For now, place the marker in row 5. 

2. Now type /D (for delete). 

The pFonq>t line will display the message 
DELETE: R(-)C(!) 

asking whether you wish to delete a row or a column. 

CAUTION: Although in this case you're only deleting an empty 
row, it's just as easy to delete a row or column fuU of 
information. Once you type R or C, the contents of 
the row or column the marker is in will be per- 
manently erased t^m the worksheet— you wiU not 
be able to get them back. Make sure you have the 
marker in the right place! If you don't, or if you 
change your mind about deleting the row or column, 
or have typed D by ^^take, you can cancel the 
Delete command by |)r^sing any key except R or C. 

3. Type R (for Row), or C (for Column). 

In this case, since you really do mean to delete the row containing 
the marker, type R. Row 5 will disappear fi-om the worksheet; 
everything below it will be shifted up one place to close up the 

space. 

"Type /DR three more times to delete the excess space and leave 
room for the row of dashes. 

Now, following the procedure you have just learned, insert a 
blank row for the dashes between PRINTING and TOTAL. 
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20. BLANKING OUT A CELL 

Let's assume you l^ve made a ^evous mistake and entered 
some data in a cell you actually wanted to leave bkmk. You have 

the choices of entering a blank label, or simply telling 
MAGICALC to blank out the cell. The latter method is 
preferable. 

To blank out the contents of a cell of the wtffksheet: 

1. Move the marker to the desired cell. 

For this example, move the marker to any cell that has 
something in it. 

2. Type IB (for Blank) 
The message 
BLANK 

will appear on the prompt line. You must press a RETURN or 
marker movement key to confirm this operation. The ESC key 
will back you out of it. This extra confirmation step protects you 
from accidentally destroying the information on your worksheet. 
MAGICALC is asking, "Are you sure you want to blank out the 
current cell?" 

CAUTION: When you press RETURN, the contents of the cur- 
rent cell will be permanently erased from the 
worksheet — you will not be able to get them back. 
Be sure this is really what you want to do! If you 
change your mind about blanking out the cell, or 
have typed IB by mistake, you can still cancel the 
Blank command by pressing the ESC key. 
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3. Press tlie RETURN to om^dete the Blank oomiiiaiid 
return to the calculate mode 

The contents of the cell will disappear from your screen, aod you 
will be back in calculate mode. 

Note: It isn't necessary to blank out a cell in order to store some- 
thing new into it. Just entering new information into a cell 
automaticaUy erases any previous information the cell may 
have contaiiied. 
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21. EDITING A CELL 

Once labels and values have been entered into cells, you may 
recall this data for editing. 

Assume you looked at your worksheet and decided FIRST PASS 
really would look better if it read PASS ONE. 

To edit the contents of a cell: 

1. Move the marker to the cell you wish to edit. 

In this case, move to cell A7, the cell in which FIRST PASS ap- 
pears. 

2. Type /E (for Edit). 

The contents of the current cell, 
FIRST PASS 

will sppesx on the osby line, with the caxmc over the first 
character. The prompt line will change to read: 

EDIT A LABEL 

since that's the kind of information the cell contains. 

3. Edit the contents of the entry line. 

The first thing you want to do is delete the letters: 
FIRST 

The right and left arrow keys allow you to move the cursor back 
and f CNTth on the enby lina Position the cursor so it follows the 
first diaracter to be deteted— in this case, spaoe fdlowing the 
word FIRST. 
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Now use the ESC key (or for Apple//e users, the DELETE key) to 
back up over the space, and the word FIBiST. 

If you try to back up past the beginning of the line, you will hear 
the femiiiar "thump," indicating that you have bumped into the 
end of the data. 

Notice the difference between the action of the arrow keys and 
the ESC 1^ in edit mode: 

Arrow keys are non-destructive cursor movement keys. 

The ESC (or DELETE) key is a destructive backspace key. 

Now, using the right arrow k^, move the cursor to the end of the 
word PASS (which is all tiiat is left on the entry line). 

If you move the cursor past the end of the data on the line, you 
will again hear a "thump," indicating that you have bumped up 
against the end of the data. The cursor wiU remain in the position 
after the last character if you were moving right, or <ni the first 
character if you were moving left. 

Type a space, thm the wcad ONE. Now, when you press 
RETURN to accept the edited entry, the label will read PASS 
ONE. 

Note: There is no "escape" from an edit, so if you delete any 
characters, do so with care, as a deleted chaiticter is p6^ 
manently lost. 

Let's assume that after looking at the display you decide that 
FIRST PASS looked better after aU. 

Position the marker aver cell A7 and type IE (edit a cell). 
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Again the message: 
EDIT A LABEL 

will appeal on the prompt line. The first thing we want to do is 
remove the space, and the word PASS, so we will use a new 

editing key: Ctrl-T. Ctrl-T truncates the text on the entry line at 
the cursor position— that is it deletes all characters from the cur- 
sor position to the right end. 

Using the right arrow key, position the cursor over the space bet- 
ween PASS and ONE. Now, press Ctrl-T (hold down the Ctrl key, 
and simultaneously depress the T key). 

The space and the word ONE are instant^ gone! Now for the ex- 
citing part: 

Move the cursor back to the first character on the line (in this 
case, the P in PASS). Now type: 

FIRST 

and don't forget the space. Did you see how each character you 
tjrped pushed all the others to the right? 

Of course, you must press a RETURN to enter the modified text. 

Note: You may enter edit mode from text or value entry mode 
simply by typing Ctrl-E. 
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22. ENTERING A REPEATING LABEL 

How about xmderlining those cohimn headings, to make them 
look more professional? You can underline each heading by filling 
the cell below it with dashes. The easiest way to do this is with a 
repeating label: a pattern of one (h: more characters that will be 
repeated as inany times as nec^sary to fill up a cell on the screen. 

To enter a repeating label into a cell of the worksheet: 

1. Move the marker to die desired celL 

The first underline goes in cell A5, so move the marker there. 

2. Now, type I— 

The dash stands for the Repeating Label command. The prompt 
line will display the words REPEAT LABEL. MAGICALC is 
prompting you to type your repeating label. Whatever you now 
type on the entry line will be repeated as many times as necessary 
to fill up the current cell (regardless of the colunm widthi). 

3. Type the repeating label. 

Since you want to fill cell A5 with dashes, type another dash. The 
first dash you typed (step 2) was a command to MAGICALC, the 
Repeating Label command. This second dash (step 3) is the actual 
repeating label itself. (This particular repeating label happens to 
be just one character long, but you can type one of any length you 
wii^.) 

As usual, you can edit the contents of the entry line or back out of 
the repeating label operation using the ESC key, or the Ctrl-E 
edit command until you press RETURN or a marker movement 
k^. 

4. When the repeating label is correct on the entry Une, press 
RETURN or a marker movement key to enter it into the cur- 
rent cell and return to calculate mode. 
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Cell A5 will fill up with dashes, as advertised! Notice that the 
contents line at the top of the screen now reads: 

A5 /— L: — 

The /— means that the cell contains a repeating label; the L: 
means that what follows is the repeating label and the dash after 
the L: is the actual repeating label itself. 

You may be wondering why you couldn't just type in enough 
dashes to fill up the ceU, instead of using a repeating label. One 
good reason is simply that it's easier to type just one dash and let 
MAGICALC do the repeating. (That's what computers are 
for— to do repetitive tasks for you.) But there's an even better 
reason: if you just type in the dashes and later decide to change 
the width of the coluMli, yotl'll suddenly find that you have the 
wrong number of dashes in ceU A5. When you use a repeating 
label, MAGICALC will always fill up the cell automatically with 
the right number of dashes, no matter how wide you make the 
column. 
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23. REPRODUCING A CELL 

To underline the three remaining column headings, you could 
repeat the procedure you've just learned in cells B5, C5, and D5. 
But (as usual) there is an easier way: you can reproduce (just a 
ten-dollar word for "ec^y") the contents of cell A5 into cells B 
through D5. 

To reproduce the contents of one or more cells into one or more 
other cells, 

1. Type /R (for Reproduce). 

The prompt line will display the message 

REPRO: (, SOURCE RANGE OR RETURN 

and the coordinate of the current cell (A5) will appear on the entiy 
line, followed by the cursor. MAGICALC is prompting you to 
specify on the entry line the cell you wish to reproduce (the 
source) and where you want to reproduce it to (the destination), 
separated by a colon. 

2. Edit the entry line, if necessary, to contain the coirect source 
coordinate(s) (those of the cell or ceUs you wish to reproduce). 

You're only reproducing a single cell this time, so the source will 
consist of just one coordinate. (In the next section you'U learn 
how to reproduce more than one cell at a time.) For convenience, 
MAGICALC assumes that the current cell is the one you're most 
likely to want to reproduce, so it automatically fills in the coor- 
dinate of that cell on the entry line. 

In this case, since the current cell is in fact the cell you wish to 
reproduce, no editing is necessary— just go on to step 3. If you 
wanted to reproduce some other cell instead, you could correct 
the coordinate on the entry line just as if you were correcting a 
typing error. 
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Note: Yoa will always get the right source coordinate filled in for 
you automatically if you begin by moving the marker to 
the cell you wish to reproduce, before typing /R (step 1 
above). However, if the cell you are reproducing is some 
distance away from the marker, you may find it easier not 
to move the marker, but to edit the source coordinate on 
the entiy line instead. Use whichever method seems more 
convenient in any particular case. 

3. When the entry line contains the correct source coordinate(s), 
type a colon ( : ) to separate the source from the destination. 

4. Supply the destination coordinate(s) (those of the cell or cells 
you wish to reproduce into) on the entry line. 

For now, just type: 

B5.D5 

from the keyboard. 

Notice when you type the period, MAGICALC expands it into 
three periods. This is because three periods is the standard nota- 
tion for ellipsis, or specification of a series by beginning and end- 
ing location. 

In the next section you'll learn another way of specifying coor- 
dinates that is often more convenient. 

The entry line should now read 

A5:B5...D5 

T^e part before the colon (A5) is the source of the rq)roduction; 
the part after the colon (B5...D5) is the destination. A destina- 
tion of this form, consisting of two coordinates separated by 
three periods (note: you never have to type the other two periods), 
is called a range, and means that you want to reproduce the 
source (A5) into every (xdl tmm B5 through D5. 
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5. When the entry line contains the correct soxirce and destina- 
tion coordinates, press the RETURN key to complete the 
Reproduce command and return to command level. The 
repeating label you entered earlier in cell A5 will be copied 
(reproduced) into cells B5 through D5, and you'll be back in 
calculate mode again. 

Again, you may be thinking that it would have been easier just to 
enter the repeating label into each of the cells separately. Well, it 
might (or might not) have been easier in our tiny example, but 
what if you had 48 monthly columns to underline instead of four 
annual ones? One Reproduce command is a lot quicker than fill- 
ing in 48 cells, one at a time! • 
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24. POINTING WITH THE MARKER 

You're ^ing to need another row of dashes to separate the 
figures for the various tasks from the totals on the "bottom line. " 
In fact, you've already made room for them in row 12 of the 
worksheet. 

You can use the Reproduce command again to copy the row of 
dashes from row 5 to row 12. But this time, instead of reproduc- 
ing just one cell, you'U learn how to reproduce a whole range of 
cells at once. And instead of typing the source and destination 
coordinates from the k^board, youTl learn how to point at the 
desired cells by moving the marker, letting MAGICALC copy 
the coordinates to the entry line for you. 

You're going to reproduce cells A5 through D5 into cells A12 
through D12. Just as you did m precedteg s^tion, begin the 
Reproduce command by typing /R. As before, the message: 

REPRO: (, SOURCE RANGE OR RETURN 

will appear on the prompt line and the coordinate of the current 
cell (A5) will automatically be copied to the entry Une, followed by 
the edit cursor. The source range is the cell, or range of cells you 
wish to r^mxiuce. 

This time, instead of just the single ceU A5, the source of the 
reproduction will be the range of cells from A5 to D5. You can 
specify a source range the same way you specified the destination 
range last time, by giving the coordinates of the first and last 
cells in the range, separated by a period. Since the first cell in the 
range is the current cell (A5), its coordinate has already been filled 
in on the entry line. Instead of typing the " . . . " separator (this is 
the MAGICALC notation for a range), we're simply going to let 
MAGICALC fill it in for us. This time, instead of typing in coor- 
dinate D5, you're going to point at cell D5 with the marker, and 
let MAGICALC fill in the coordinate for you automatically. 

To specify a coordinate by pointing with the marker simply use 
any of the matter movemait keys (right and left arrow keys, 
Ctrl-Q, Ctrl-A, Ctrl-S, Ctrl-Z, Ctrl-W, Ctrl-X, Ctrl-R, and 
Ctrl-C) to move the marker to the cell. 
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As soon as you press one of the marker movement keys, MAGI- 
CALC fills in the " . . . " separator, and copies the coordinate of 
the cell upon which the marker is resting onto the entry line as 
the last cell in the range. 

You may use the space bar to switch the marker movement direc- 
tion at any time during this process. 

As you continue to move the marker, the cell coordinate 
displayed on the entry line changes. Type Ctrl— S three times to 
move the marker three cells to the right, to the last cell in the 
range you wish to reproduce (D5). 

3. Now you must supply the punctuation character that is to 
follow the coordinate on the entry line. In this case it is a 
colon (:). 

A punctuation character is a character used as a separator (much 
the same as punctuation characters are used as separators in the 
EngUsh language). In MAGICALC, you wiU be using the colon 
(:) as the punctuation character that separates the source range 
from the destination range in the Rqjroduce command, and fjie 
period (. ) as the punctuation character that separates the beginn- 
ing and ending cells in each of these ranges. 

Other punctuation characters are used in MAGICALC, but they 
are better thought of as arithmetic operators (+, -, I, *), or rela- 
tional operators «,>,=,<=,> = ). We will go into the uses of 
some of the arithmetic operators later in the Tutorial. All the 
operators will be covered in the Reference Guide. 

Once the punctuation character is typed, MAGICALC will 
display the message: 

REPRO: ENTER TARGET RANGE OR RETURN 

on the prompt line. The target range is the cell or range of cells to 
which you want to reproduce your source cell(s). 



49 



MAGICALC Tutorial— Pointing With The Marker 



MAGICALC will try to prevent you from making obvious errors. 
For example, if you had typed: 

B1...E1 

on the entry Une, and then tried to enter a letter, rather than a 
colon, MAGICALC would beep at you, then wait for you to make 
an acceptable entry. Some errors are impossible for MAGICALC 
to detect, for example, if you had t}T)ed a 0, rather than a colon, 
MAGICALC would assume you meant to use coordinate ElO. 
Fortunately, the ESC key will back up over mistakes of this 
nature. 

Note: If you press the RETURN key instead of a punctuation 
character, MAGICALC will insert a colon (:) and prompt 
you for the target range. You may make any corrections 
necessary using the ESC key simply by bacMng over the 
colon, and the erroneous letters or numbers. 

As shown on the prompt line, the source and destination are to be 
separated on the entry line by a colon; so type a colon (:), if you 
haven't alimdy done so. The marker wiU jump back to cell A5. 
The entry line should now read: 

A5...D5: 

Now you can supply the destination coordinate in the same way. 
Use the marker movement keys (either the arrow keys, or the Ctrl 
keys) to move the marker down to cell A12 (which is the first cell 
you wish to reproduce into. 

Notice that as soon as you press one of the marker movement 
keys, the cell on which the marker is resting appears on the entry 
line immediately following the colon ( : ). By now, you should b»e 
getting the idea of pointing with the marker. 

The entry line should now read: 

A5...D5:A12 
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This means you want to reproduce the range df cells ftom A5 to 
D5 (the source) to locations beginning at A12 (the destination). 
Now press RETURN to complete the Reproduce command, and 
the row of dashes will be copied from cells A5 to D5 into A12 to 
D12. 

Note: Notice that you didn't have to specify the entire destina- 
tion range, just the first cell. When the source you specify 
is a range and the destination is only a sdi^e c^, the actual 
destination is understood to be a range of cells, with the 
same dimensions as the source, beginning at the requested 
destination coordinate. 

You've now learned two different ways of specifying the coor- 
dinate of a cell: (1) by typing the coordinate directly from the 
keyboard, and (2) by moving the marker to point at the cell using 
any of the marker movement keys. 

Now that you know both methods, you can use the one that's 
more convenient in any particular case. If you make a mistake at 
any point in this process, you are free to use the ESC key to 
backspace over the error, then either retype the correct informa- 
tion, or point with the marker. 

Just for practice, use the Reproduce command to copy the rate 
from C6 to cells C7 through C9. 

Now enter the rate for TYPESETTING in cell CIO just by enter- 
ing the value 19. 
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25. INITIALIZING A DISKETTE 

By now you've done quite a bit of work on the demonstration 
model— it would be a pity if the lights went out and you had to 
reconstruct it all from scratch. It's a good idea to save the con- 
tents of your worksheet frequently on a floppy diskette, as in- 
suranre against disast^. Th^ if someone shotild happen to trip 
over your Apple's power cord, you can back up to the last version 
of the worksheet you saved, losing only the work you've done 
since then. Accidents do happen— don't "play far more than you 
can afford to lose!" 

Before you can store any inf(H3niition on a diskette, you first have 
to initialize the diskette. Once the diskette has b^n initialized, 
you can add more information to it whenever you wish. So there's 
no need to initialize a diskette every time you want to save your 
wtKksheet— s'ou on^ have to do it the first time you use a par- 
ticular diskette. 

Take a blank diskette and write something descriptive on the 
label, such as "MAGICALC Storage Diskette" and the date. 

CAUTION: Never use anything but a felt-tip pen to label a 
diskette, and don't press down too hard, to avoid 
damaging the surface of the diskette inside its black 
jacket. If you're using a gummed label that isn't 
already attached, it's sa£^ to write on tiam label 
before attaching it to the diskette. 

Note: Always label a diskette the first time you store anything on 
it, so the next time you pick it up you'U know what it con- 
tains. 

To initialize a diskette: 

1. Place the diskette 3rou wish to initialize in one of your disk 
drives. 

Open the door to any disk drive and carefully insert the diskette 
you just labeled, with the label nearest you and facing up. (If you 
hold the diskette with your thumb on the label, you will have it 
facing properly.) Push the disk gently into the disk drive as far as 
it will go, then gently cbse the disk drive 6oar. 
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2. Type /S (for Storage). 

The prompt line will change to read: 

ENTER LOWER RIGHT OR RETURN 

You will only need to enter a lower right coordinate if you are us- 
ing DIF files (DIF files will be covered in the Reference Guide), 
and do not wish to save the entire worksheet. 

Press the RETURN key. 

The following menu will be displayed: 



FILE SUBSYSTEM 

A. STARTING CELL 

B. ENDING CELL 

C. USE DIF FORMAT. . . . 

D. ROW ORDER FOR DIF. 

E. DISK SLOT 

F. DISK DRIVE 

G. DISK VOLUME 



MAGICALC SYSTEM MENU 



2. CHANGE OPTIONS 

3. SAVE WORKSHEET 

4. LOAD WORKSHEET 

5. FILE CATALOG 

6. LOCK A FILE 

7. UNLOCK A FILE 

8. INITIALIZE DISK 

9. DELETE A FILE 



SELECT NUMBER OR LETTER, PRESS RETURN 
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Note: If you press the ESC key twice, it will back you out of the 
Storage command, and return you to the calculate mode. 

3. Make sure the Disk Slot (option E) and Disk Drive (option F) 
correspond to the disk drive in which 3rou placed your blank 
diskette. 

Slot and drive numbers are explained in Chapter 3 of the Apple 
Disk Operating System (DOS) Manual that came with your disk 
drives. If you only have one disk drive, you don't need to worry 
about slot and drive numbers: MAGICALC will set them for you 
automatically. You can skip this step and just go on to step 4. 

If you have more than one disk drive, you must make sure the 
slot and drive numbers on the prompt line correctly identify the 
drive the diskette is in. Whenever you start up MAGICALC, the 
slot and drive numbers are automatically set to those of the main 
disk drive (the one you used to start up the system). So if you 
placed the blank diskette in that drive, the slot and drive 
numbers are guaranteed to be correct, and you can go on to step 

4. If you are using a different disk drive, you have to change the 
slot and drive numbers to the correct ones before going on. 

To change any of the options, you may move the highlight bar 
(which should be restmg on MAGICALC SYSTEM MENU) 
either by using the right and left arrow k^s, or by typing the 
number of the menu item you wish to select. 

In order to actually make a selection, you must first move the 
highli^^t bar, as described above, then press the RETURN key, 
car repeat the number or letter of the option to confirm the selec- 
tion. 

For example, we could select item 4-LOAD WORKSHEET 

By pressing the arrow keys until the highlight bar was over it^ 
4, then pressing the RETURN key; by typing 4, then pressing 
the RETURN key; by typing 4 twice. To change the Disk Drive, 
type the letter F. The Idghlight bar will inunediately jump to F 
DISK DRIVE. 

Now, press RETURN to confirm your selection. 
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At the bottom of the screen the following prompt will appear: 
ENTER, (MIN = 1, MAX = 2): 
Followed by a blinking cursor. 

This prompt is telling you the acceptable values for this entry. 
MAGICALC wiU beep and wait for reentry if you type any ill^d 
charactais or values. 

If you simply press RETURN, the entry will r^nain imchanged. 

ESC will always back up, just as in the calculate mode, so if you 
press ESC, the cursor wiU back over any entry, and when there is 
no more data to back over, you will see the highlight bar jump im- 
mediately to 1. MAGICALC SYSTEM MENU. 

Note: The ESC key will back you out of any menu operation, and 
if you keep pressing it, you will wind up in calculate mode. 

You can change the slot number the same way, exwpt you must 
sel^t item E. 

4. Move the highlight bar to item 8. INITIALIZE A 
DISKETTE using either the arrow keys, or by typing the 
number 8. 

5. Press RETURN to confirm your selection. 
The message: 

INSERT DISK TO BE ERASED 

HIT<RETURN>TO CONTINUE 
<ESC>TO ABORT 
will be displayed on the screen. 

Caution: If you reinitialize a diskette that already has informa- 
tion stored on it, the diskette will be wiped clean and the 
information it previously contained will be permanently 
erased. Never initialize a diskette imless you're sure it 
doesn't contain useful information that you want to 
keep. 
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Since initializing a diskette will erase any previous information it 
contains, MAGICALC is giving you a chance to "back out" safe- 
ly, without destro3dng any information. 

Note: If you change your mind or have made a mistake, you can 
now cancel (or "abort') the Initialize command by pressing 
the ESC key. 

In this case, you really do want to initialize the diskette, so 
6. Press the RETURN key. 

The red IN USE light on the firont of the disk drive wiU come on, 
and the disk drive will begin making its usual noises. After about 
30 seconds the noises wiU stop, the IN USE Hght will go off, and 
you wiU be returned to the FILE SUBSYSTEM. The diskette is 
now initialized and ready to receive information. 

Note: Remember, you don't need to initialize a fresh diskette 
every time you want to save your worksheet. Once a 
diskette has been initiaHzed, you can always add more in- 
formation to it. So the next time you save the worksheet 
you can just use the same diskette, without reinitializing it. 
(In fact, if you do reinitialize a diskette after storing infor- 
mation on it, all the information it contains will be per- 
manently erased.) 

Note: The diskette you have initialized is not like a normal Apple 
diskette as it does not contain the disk operating system on 
it. What this really means is that you cannot boot it. 

Press the ESC key twice to return to calculator mode. 

Note: It is always safe to use the ESC key to exit a m^nu— if you 
use the RETURN key, you may inadvertently select a 
menu item you had not intended to. 
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26. SAVING THE WORKSHEET 

Now that youVe initialized a diskette, you can save the contents 
of the worksheet on it. 

To save the worksheet on a diskette: 

1. Make sure the diskette you wish to use is in one of your disk 
drives. 

MAGICALC storage diskette that you've just initialized should 
still be in the disk drive, so just go on to step 2. 

2. From calculator mode, type IS (for Storage), then RETURN. 

Once again, your worksheet display will be replaced by the File 
Subsystem menu. 

3. Make sure the Disk Slot and Disk Drive numbers on the 
menu are the correct ones for the disk drive you're using. 

You've already set the slot and drive numbers (or had them set 
for you automatically) when you initialized the diskette in the 
preceding section. Since you haven't moved the diskette to a 
different drive, these settings should stiQ be correct, so just go on 
to step 4. 

4. Move the highlight bar to item 3. -SAVE WORKSHEET, 
and press RETURN to confirm your selection. 

Ordinarily, a list of files would be displayed on your screen. These 
files would be numbered for easier selection. Since you are using a 
freshly initialized diskette, there will be no file display this time. 

At the bottom of your screen the prompt: 

ENTER FILE NAME OR NUMBER, OR <RETURN> 

will be displayed and the edit cursor will appear. MAGICALC is 
prompting you to supply the name under which you wish to file 
this worksheet on the diskette (or the number of the file, if it is 
listed in the file catalog). 
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Note: The word file refers to a unit of information stored on a 
diskette, such as the contents of a worksheet. A diskette 
may contain any number of files, as long as theif" total 
length doesn't exceed the diskette's capacity of 143 
kilobytes. Whenever you write a file on the diskette, you 
must give it a file name, so that you can find it later. A file 
name may consist of any sequence of characters you wish 
(including spaces and punctuation marks), provided that 
the first character is a letter of the alphabet. 

5. T5T)e the file name you wish to use. 

Since this demonstration model does program documentation 
planning, let's file it under the name PROGRAM PLAN. Tj^je 
the letters PROGRAM PLAN. What you type will appear on the 
entry line, followed by the edit cursor. This gives you a chance to 
edit the name using the ESC key to back up in case you make a 
t5^ing error. 

Caution: A diskette cannot contain two or more files with the 
same name. If there is alrea%^ a file on the diskette with 
the same name you t5^e now, that file's previous con- 
tents win be permanently erased and replaced with the 
cuxrrait contmts of the worksheet. You wiU be given no 
warning that you are about to destroy information on 
the diskette, and no opportunity to confirm your inten- 
tions. Make sure you don't use the same name as any 
file you want to keep! 

You don't have to worry about the name you choose this time, 
since you've just initialized the diskette and you know it's empty. 
But be carefiil the next time you save a worksheet! 

6. Wimn the file name is corr^t, press the RETURN key to 
complete the Save command. 

The red IN USE light on the front of the disk drive will come on, 
and the drive will whir for a few seconds. When the light goes off, 
a new catalog of the diskette will be displayed, with your new file 
on it. 
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Note: To interrupt a catalog at any time, press the ESC key. You 
will be spared the rest of the catalog listing. 

The pF(ni^>t: 

<RETURN> TO CONTINUE 

will appear at the bottom of your screen. 

When you press RETURN, you will be returned to the File Sub- 
system menu. 

Press RETURN twice to get back to the cadbilat(nr xmde. 
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27. STARTING A NEW WORKSHEET 

Now that you've saved your model on the diskette, you need to 
know how to load it bade in from the diskette to the worksheet. 
First let's start a new, empty worksheet, so you can see the infor- 
mation you saved reappear when you load it back in. 

Note: It is necessary to clear the worksheet every time you load a 
diskette file unless you want to overlay the one that is cur- 
rently in memory. 

To start a new worksheet: 

1, Type /C (for Clear). 
The message: 

CLEAR: TYPE Y TO ERASE EVERYTHING 
wiU appear on the pronq)t lina 

Caution: If you now type Y, a brand-new worksheet wiU be start- 
ed, permanently erasing the worksheet's previous con- 
tents. Be sure this is really what you want to do! If 
you're going to need the ciurent worksheet again, 
always be svire to save it on a diskette file before start- 
ing a new one, so it will be available to load back in later. 

Because the effect of the Clear command is irreversible, 
MAGICALC stops and asks whether you're sure this is what you 
want to do. This extra confirmation step protects you from ac- 
cidentally destroying the infomiation on your worksheet. 

Note: If you change your mind about starting a new worksheet, 
or have typed IC by mistake, you can still cancel the Clear 
command by pressing any key except the letter Y. 

Since you really do want to start a new worksheet this time, 

2. TVpe Y (for Yes). 
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All the information on the worksheet will disappear and the 
marker will jump to the top-left comer (cell Al). You now have a 
fresh, empty worksheet to work with. 

Notice that the width of column A is reset to 7, rather than re- 
maining at the 11 we set it at on the previous worksheet. The 
reason for this is that all new worksheets begin with a set of 
modifiable defaults, and the default for column width is 7. 

If you'd like to take a break and continue your lesson another 
time, now would be a good time to do it. Turn off yam Apple ][ 

and video monitor, remove MAGICALC storage diskette that 
you've just created, and put it away in a safe place. When you're 
ready to resume your lesson, start up MAGICALC again (using 
the procedure given under STARTING MAGICALC at the 
beginning of this manual) and continue with the next section. 
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28. LOADING THE WORKSHEET 

Now you can load the program documentation planning model 
back into the worksheet from the diskette file where you saved it. 

Caution: Loading the worksheet from a diskette file permanently 
overwrites any previous information already on the 
worksheet. If the worksheet contains information you're 
going to need again lata-, always be sure to save the old 
worksheet on a diskette file before loading a new 
worksheet. 

Note: When you load a worksheet over another one, the cells that 
are blank in the worksheet you load will still have the old 
data in them. This is why it is important to dear out the old 
data in most cases. 

To load the worksheet from a diskette: 

1 . Make sure the diskette you wish to load fi:x)m is in one of your 
disk drives. 

If your MAGICALC storage diskette isn't already in a disk 

drive, put it in one now. 

2. Type /S (for Storage). 
The message: 

ENTER LOWER RIGHT OR RETURN 

will appear on the prompt line. 

Type RETURN to enter the File Subsystem. 

3. Make sure the Disk Slot and Disk Drive numbers on the 
menu are the correct ones for the disk drive you're using. 
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If you have only one disk drive, just go on to step 4. If you have 

more than one drive, recheck the slot and drive numbers on the 
menu to verify that they correspond to the drive you're using. If 
you need to change the slot or drive number, refer back to 
INITIALIZING A DISKETTE, above, for details on how to do 
it. 

You've already used two of the File Subsystem options. Initialize 
and Save. Now you're going to use the Load option: 

4. Move the highUght bar to item 4. LOAD WORKSHEET 
using the arrow keys, or by typing 4. 

As befwe, you will have to press RETURN to confirm your 
choice. A catalog of the diskette will be displayed on your screen. 
Since you only have one file on the diskette, you will see the 
following display: 

1. T PROGRAM PLAN 

and at the bottom of the screen the prompt: 
ENTER FILE NAME OR NUMBER, OR <RETURN> 

5. Type the file name or number of the worksheet you wish to 
load. 

The file name you used earher when you saved the worksheet was 
PROGRAM PLAN, so type that name back in now, or simply 
type the number 1. What you type will be displayed on the screen 
foEowed by the cursor, so you can edit the name if necessary to 
correct tST^g errors. 

6. When the file neune or number is correct on the entry line, 
press the RETURN key to complete the load command and 

return to File Subsystem menu. 

Now press the RETURN key twice, and you wUl be back in 
calculate mode. The demonstration model will reapp^ on your 
screen, just as it was when you saved it on the diskette. 
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29. ENTERING A FORMULA 

Now we oome to MAGICALC's most powerful feature of all, the 
one that makes it such a useful, versatile tool. Instead of putting 
a simple numerical value or a piece of text into a cell, you can 
enter a formula representing a calculation, which may be based 
on the contents of other cells. Then, whenever you change the 
contents of any of the cells the formula is based on, the value of 
t^e fonnula w^ be recalculated automatically to reflect the new 
data. 

You're going to enter a formula in cell D6, then reproduce it to 
other cells in column D. We know that column D is the COST col- 
umn, and we also know that COST = HOURS times RATE. 

MAGICALC uses the sjonbol * (asterisk) to stand for multiplica- 
tion, so our fonnula might better be stated: 



COST= B6*C6 

We know where the cost cell is, so let's move the marker there 
now (cell D6). 

Here's where the trick comes in: if you enter B6*C6, 
MAGICALC will look at the first letter of the formula, and 
noting it is a letter, will assnune you are entering a label. In orda' 
to let MAGICALC know that you are entering a formula, enter: 

-I- B6*C6 

Note: You may use the marker movement keys to point to the cell 
you want, just as you did when you were using the 
Reproduce command. The procedure for this is to type the 
plus sign to signify that a value will be entered, then begin 
moving the marker. As before, when the marker is moved, 
the cell coordinates that it passes over will be displayed on 
the entry line. When you have moved the marker to B6, 
you simply type the asterisk (*). The marker will jump 
back to D6. You may tiam dtte- enter the coordinate C6 
directly, or point to it with the marker. 
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Note: You are free at any time to use the ESC key to bade up ova- 
incorrect entries. You may also "jump" into edit mode 
using the Ctrl— E key (see Editing a Cell). 

To actually enter the formula, press the RETURN key or any of 
the marker movement keys. 

Press the RETURN key now, and watch as your formula is 
calculated instantly on the screen. 

Now, to demonstrate some of the power of MAGICALC, assume 
the research phase of the project took only 59 hours. Move the 
marker to ceU B6 and type 59. 

As soon as you hit the RETURN key, not only is the current cell 
(B6) updated, but also all cells that rely on it for calculations. 
Look at cell D6— the contents should reflect the new data for 
hours! 
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30. TIME OUT FOR SOME HOUSEKEEPING... 

This would be a good time to save your work again, so that if 
anything should go wrong you won't have to reconstruct the foi> 
mulas you've just entered. If you've been following the instruc- 
tions carefully, your MAGICALC storage diskette should still be 
in the same disk drive you left it in when you loaded the 
worksheet from it earlier. Just as before, type IS {for Storage), 
then RETURN, in response to the message: 

ENTER LOWER RIGHT OR < RETURN > 

You will be presented with the File Subsystem menu (which you 
have learned to use in previous sections). 

Select option 3-SAVE WORKSHEET. 

Caution: Remember, if you save the worksheet now under the 
same file name as last time, the new version of the file 
will replace the old one on the diskette, and the previous 
version will be permanently erased. Be careful not to 
destroy a file you may want again later! 

You will again (as with all File Subsystem commands) get a 
catalog of the disk you have specified as your data diskette. 

Ordinarily there would be no need to hang onto tl^ old version of 
the model you're building, so you could just type the number of 
the file name that contained your model to save the new version 
under the same file name as before. Sometimes, however, you 
may have scnne special reason to want both the earlier and later 
versions of the modd available on the diskette at the same time. 
(For instance, you may be trying out some changes that you're 
not sure you want to keep permanently.) In cases such as these, 
yoa will want to specify a different file name. 

Note: You may not select a new file by number— you will have to 
type the name in. 

Let's save this worksheet under the name PROGRAM PLAN 1. 
To do this, simply type in PROGRAM PLAN 1 in response to 
the prompt. 
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The red in-use light will come on, and the disk will i^in for a 
while, then you will be shown a new catalog of the disk. This new 
catalog is provided to confirm to you that the operation you re- 
quest^ has indeed taken place. 

Just to verify that the old and new versions of the PROGRAM 
PLAN model are both stored on the diskette, try loading the old 
version back in, then the new one again. From calculate mode, 
type: 

/C 

to clear the worksheet. You wiU be prompted: 

CLEAR: TYPE Y TO ERASE EVERYTHING 

Since you want to clear the worksheet, type Y. 

Now type IS (for storage), and a RETURN to enter the file sub- 
system. Select option 4-LOAD WORKSHEET 

You will be shown the familiar catalog of the diskette. There 
should only be two files on the diskette: 

1. T PROGRAM PLAN 

2. T PROGRAM PLAN 1 

Notice the numbers to the left of the file names. These are the 
numbers referred to in the prompt: 

ENTER FILE NAME OR NUMBER, OR <RETURN> 

In order to load PROGRAM PLAN, simply tj^e the number 1, 
and press the RETURN key. 

Press the ESC or RETURN key twice to return to the calculate 
subsystem. Your worksheet should appear intact. 

Now clear the worksheet as you did before, and tod PROGRAM 
PLAN 1 by selecting number 2. 



67 



MAGICALC Tutorial — Reproducing Formulas 



31. REPRODUCING FORMULAS 

In order to fill up the cost column, we must reproduce the formula 
contained in cell C6 into the cells C7 through ClO. 

Reproducing a formula is much the same as reproducing a cons- 
tant cell (a constant cell is one that does not depend on any other 
cells). Start by placing the marker in cell C6. 

Now type: 

/R 

for reproduce. The message: 

REPRO: (, SOURCE RANGE OR RETURN 

wiU appear on the prompt line. Since you only want to reproduce 
the one cell, press the RETURN key. MAGICALC will 
automatically insert the colon (:) punctuation character for you. 

The message: 

REPRO: ENTER TARGET RANGE OR RETURN 

will appear on the prompt line. Notice that the contents line 
shows your formula: 

+ B6*C6 

Now fill in the target range just the same way as you did when 
reproducing a value— either by typing the coordinates directiy, or 
by pointing with the marker. The fin^hed entry line should read: 

D6:D7...D10 

As soon as you press RETURN to enter the Reproduce com- 
mand, something new appears on the prompt line: 

REPRODUCE: N = NO CHANGE, R = RELATIVE 

and your entry Une changes to read: 
D6:D7.D10 + B6*C6 
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The blinking cursor will appear over the 6 in B6. What 
MAGICALC is prompting you to do is specify whether the coor- 
dinate B6 in the original formula should be reproduced relative to 
the position of the location of the destination cell, or should re- 
main B6 in all cases. For example: 

If you specify R for relative, the formula in cell D7 wiU have the 
coordinate B6 (from the original formula) replaced with B7. 
Likewise, in D8, B6 will be replaced with B8, etc. 

Sometimes, like when you are computing percentage of total, you 
will want one coordinate to remain the same, and other coor- 
dinates in the formula to vary. 

For our case, we do want a relative reproduction of the formulas, 

so type the R key. 

The cursor immediately jumps over to the 6 in C6. MAGICALC 
will ask you the N = NO CHANGE, R= RELATIVE question 
for each coordinate in your iannvla. 

We also want to reproduce the rate coordinates relatively, so type 
R. 

Your formulas wiU all be reproduced, and the values will be filled 
in for all the cells. 

To verify that the formulas were reproduced relative to their cell 
position, move the marker to cell D7. 

The contents line should now read: 

+ 87* C7 

As you move the marker down the cells in column D, you will see 
that the reproduction of the formula did occur relative to the cell 
position. 

Now, move the marker to cell Dll to enter the cost of printing (an 
outside cost so we don't have to get the hoiu-s or rate). This is a 
simple value, so all you have to do is type in the number. 
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32. USE OF FUNCTIONS 

MAGICALC provides us with a number of useful functions with 
which to manipulate our data. In this example, we are only going 
to look at one of those functions— the SUM function. All the 
functions are covered in detail in the Reference Guide. 

Let's get a total for hours and for cost. You can probably figure 
out tluit the total for hours can be expressed as: 

+ B6 + B7 + B8 + B9 + BIO 

This is rather clumsy, and at a certain point, you will almost cer- 
tainly begin to create models that have columns of such length 
that such a method ol notation is inqxrasible. 

Rather than adding each cell individually, we have the function 
@SUM (pronounced at-sum). Note the @ (commercial "at sign"). 
The @ informs MAGICALC that you are entering a value, and 
that the vahie is to be derived from one of the built-in functions. 

The best -vay to get the total hours is to move the marker to cell 
B13 and enter tl^ following: 

@SUM( 

Notice that as soon as you strike the @ 1^, the prompt line 
changes to read: 

VALUE 

Most functions have arguments. An argument is a parameter 
that specifies to the function what cells to operate on, and in some 
cases, what the rules of the operation are. 

@SUM requires a range of cells as an argument. This range will 
be summed, and any cell within the range not amtaining a 
numeric vfdue will be disregarded. 

You will recall, from the discussion on the Reproduce command, 
that a range of cells is specified as: 

beginning. . .ending 
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So in our case the sum of the hours column is represented by the 
sum of the range B6...B11. 

Once you have typed the left parenthesis, you may either specify 
the first cell in the range by typing the coordinate B6, or you can 
point with the marker, just as you did in the Reproduce com- 
mand. 

The entire formula you will be typing (or retrieving by pointing 
with the marker) is: 

@SUM(B6...B11) 

You may use the ESC key to edit information on the entry line 
imtil it is correct, then use any of the marker movement keys to 
enter it. 

The total is immediately displayed in cell B13. 

Now, using the same technique, place the total of the cost column 
(column D) in cell D13. 
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33. GLOBAL FORMATTING 

Now we have all the numbers and titles in our model, but the for- 
matting is just a littJe vmmg. Wouldn't it be nicer if the rate and 
cost figures came out in dollars and cents? 

We can set the format of the worksheet such that all numeric 
values display to two decimal places. This is caRed global format- 
ting. 

Type: 

/G 

The prompt line will change to read: 
GLOBAL: G O R F A 

As usual, the prompt line is redting a list of your qptions. In our 
case, we want to use F for format. 

As soon as you type the F, the prompt line changes to read: 
FORMAT: D G I L R $ * 

These various choices will be explored in depth in the reference 
manual. For now, simply type the dollar sign ($). 

Immediately, two things will happen: 

• The hours and rate coltunns will appear in doUars and cents 
format. 

• Most of the cost colxunn will fill up with less-them (<) 
characters. 



33.1. What Is Overflow? 

The reason your model now shows less-than signs in column D is 
that there is no longer enough room in column D to display the 
nvunber with two trailing decimal digits. As a warning, 
MAGICALC displays the less-than sign as an overflow symbol. 
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In order to fix this problem, simply move the marker over to col- 
umn D and use the /L (column width) command as follows: 



Type: 
/L 

When the COLUMN WIDTH i»ompt apfiears on tto pcowpt 
line, type: 



9 

When you pr^s the RETURN key, the column will have room to 
display all the digits required. 
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34. CELL FORMATTING 

Since we are not counting hoiirs to two decimal places, it would 
be better if we had left them as whole numbers. In computer talk, 
we call whole numbers integers. 

Fortunately, MAGICALC allows you to format each cell in- 
dividually if the global format does not suit the type of data con- 
tained in that cell. 

The wisest thing to do is to set the global format to the format 
that wiU be most often used in your model, then change the ex- 
ception cells to more appropriate formats individually as follows: 

Move the marker to the cell you wish to format. In this case, you 
want to format cell B6. 

Now type: 

IF 

The format prompt that you saw when you performed the global 
format will appear on the prompt line: 

FORMAT: D G I L R $ * 

This time, instead of selecting the dollar sign ($), type I for in- 
teger. 

Notice how the number is displayed as a whole number? If your 
niunber had been 65.7, the integer format would have rounded up 
following the rouiuling rule: Less than half rotmds down, half or 
greats rounds up. 

Format the rest of the numbers in column B as integers. 

Do you notice anj^hing else that would make the worksheet more 
attractive? 

How about right justifying the column headings? 
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Right justification is done just like integer formatting: 

• Move the marker to the cell you want to format (in this case 
A4). 

• Type/F 

Your familiar prompt line will appear, offering you a variety of 
formatting choices. This time: 

• Type R li^)- 

The text in the cell will immediately jump to the right hand side 
of the marker. This feature is excellent for column headings 
because numbers automatically right justify. 

Now follow the same procedure for B4 through D4. 

Your demonstration model should look just like our example. 
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35. PLAYB<fG"WHATIF...7" 

A toecasting model is never a static entity. What if we assume 
that we can get the first pass done for 26% less per hour. How 
will that affect the total cost? Let's ask MAGICALC and find 

out. 

Move the marker to the rate figure for first pass in cell C7. Bight 
now that cell contains the number 24.48, as you can see on the 
contents line. We want to replace that number with the number 
that represents 75% of the number that is currently in there. We 
could type this in, but there is another way to do it: Type a plus 
sign ( + ) to indicate that a formula is forthcoming, then either 
type the coordinate C7, or move the marker bade and forth to 
bring the coordinate onto the entry line. Since what we're really 
interested in is the value in the cell, and not the coordinate, let's 
just fetch the value out by pressing the pound sign (# ). 

You'll see the + C7 immediatdy replaced by the value fixnn the 
ceU: 24.48. 

Now you can continue with the fcHinula by typing: 
*.75 

to multiply the old value by .75. You may enter the formula as it 
is, or yaa may use the immediate calculation feature to enter a 
vsHoB, rather than a formula. 

As soon as you enter the new information, the cost figure for first 
pass, and the total cost are recalculated to reflect the current 
data. 

Obviously, this example is somewhat trivial, but the power of 
this interactive recalculation should be readily apparent, especial- 
ly if you sore watching annual totals based upon changing 
assumptions, or bottom line figures based upon package bids 
submitted by various suppliers. 
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36. DELETING A DISKETTE FILE 

Since you'll only be keeping one version of the PROGRAM 
PLAN model from now on, you have no further need for PRO- 
GRAM PLAN 1, so you might as well delete it from 3rour storage 
diskette. 

To delete a file from a diskette. 

1. Make sure the diskette you're deleting from is in one of your 
disk drives. 

Your MAGICALC storage diskette ^ould still be in the disk 
drive, so just go on to step 2. 

2. From calculator mode, type IS {for Storage). 
The familiar prompt message: 

ENTER LOWER RIGHT OR RETURN 

will appear on the prompt line. 

press the RETURN key to enter the File Subsystem. 

3. Make sure the Disk Slot and Disk Drive numb^ on the 
menu are the correct ones for the disk drive you're using. 

In this case, the slot and drive nimibers should already be set cor- 
rectly from your last Storage operatitni, so just go on to step 4. 

4. Select optaon 9— DELETE A FILE Iqr nmnber, or by mov^ 
ing the hi^^ilight bar. 

A catalog of the files on your disk will be displayed, as in the Save 
and Load command. 

The file you wish to delete is PROGRAM PLAN 1. You've now 
learned two different ways to supply a file name to the File Sub- 
system. (1) use the name you see in the catalog; (2) use the 
number to the left of the name in the catalog. 
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5. When the file name or number is correct on the entry line, 
press the RETURN key to complete the deletion. 

Caution: As soon as you press RETURN, the file you've specified 
will be erased permanently from the diskette, and you 
will not be able to get it back. Be sure this is really what 
you want to do! 

When the deletion is complete/ the n^w 'catalog (without PRO- 
GRAM PLAN 1) will be displayed on your screen. This to let you 
know that what you specified actually took place. 

Note: If you change your mind about deleting the file, or have 
sdected optim 9— DELETE] A FILE by mistake, use the 
ESC key to back out of this command. 
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37. MORE WHAT IP...? 

Let's play a few more "what if. . .?" games with our numbers to 
demonstrate the flexibilKy of MAGICALC. 

We have made no provision for overhead allowance. Project 
overhead typically varies from 20 to 40% of the total time (hence 
cost) of the project. 

This means that our cost f(»mula must be modified to include an 
overhead number. 

Currently, we define cost as rate * hours. What we really mean to 
do is define cost as: rate * hoars * (1 +overhead%). 

Notice the parentheses in the new formula? MAGICALC will 
evaluate everything in parentheses he&xe anything else. Here's 

an example: 

24.48 * 65 * 1 + .20 = 1591.40 
24.48 * 65 * (1 + .20) = 1909.44 

MAGICALC evaluates aqtressions in a left to right fashion, ex- 
cept as altered the use of parentheses. 

So our formula in D6 really ought to be: 

+ B6*C6*(1 + .20) 

Now, let's change all the other formulas in column D to reflect the 
change. To do this, we use the Reproduce command. 

Simply type: 

/R 

The prompt line will change to read: 
REPRO: (, SOURCE RANGE OR RETURN 

and the coordinate D6 will be filled in on the entry line. 
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Since D6 is indeed the source coordinate, simply type RETURN 
or colon ( : ) to separate the source from the destination. Now the 
prompt line will request: 

REPRO: ENTER TARGET RANGE OR RETURN 

You may specify the cells D7 through DIO either by pointing 
with the marker, or by typing them in directly. The finished entry 
for the Rq)roduce command is: 

D6:D7...D10 

As soon as you press RETURN, you will be prompted: 

REPRODUCE: N = NO CHANGE, R = RELATIVE 

Just as before, you want both column B and column C treated in 
a relative fasWon in the reproduction. Simply type R twice. 

In the blink of an eye, your model is recalculated to reflect the 
new formula, and the total of column D is adjusted appropriately. 

Remember we said that the overhead could vary? The formula we 
entered still relies on a static overhead number. Changing the for- 
mula each time we want to see the effect of a different overhead 
percentage is one way to play "what if...?" 

Perhaps a better way to test the effects of overhead on the bot- 
tom line is to create a new cell to contain the overhead percentage 
and make the formulas in column D dependent on the current 
value of that cell. Let's do that now. 

Move the marker to row 4 (your column titles), and insert two 
rows by typing: 

/IR 
/IR 

Now you should have two extra blank rows between your 
worksheet title and you column titles. Move the marker to cell A4 
(if it is not already there). 



80 



MAGICALC Tutorial-More "What U...T 



Type the title: 
OVERHEAD 

Move the marker to cell B4, and enter the proposed overhead 
figure of 27% by typing: 

27 

Now, move the marker to cell D8 and edit the formula there «e by 
typing 

IE (for edit) 

Move the cursor to the close parenthesis, and use the ESC key to 
erase the .2 (press ESC twice). 

Now type in the following replacement: 

(B4/100) 

The reason we use the parenthesized expression (B4/100) is that 
we expressed the percentage in cell B4 as a whole number, but we 
can only use it in our formula as a decimal fraction. Remember 
that the parentheses indicate an expression that MAGICALC 
must evaluate before any others. 

The final formula on the entry Une will be: 

+ 88*08 *(1 +(84/100)) 

To clarify the order of evaluation of this formula, let's take it step 

by step, just as MAGICALC will. 

1. Get value from cell B8. 

2. Multiply it by the value in cell C8. 

3. Encountered a parenthesized expression— save the current 
value, which is B8*C8 and evaluate the expression within 

parentheses). 

4. 1 +oh, oh— another parenthesized expression— save off the 

current value, which is 1, and evaluate it. 

5. Get value from B4. 
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6. Divide by 100. 

7. Fetch the last value outside the parentheses (which is 1), and 
add. 

8. Back out of another level of parentheses— get the saved value 
(which is B8*C8) and multiply. 

That may seem like a lot of steps, but it is important to bear this 
OTxier of evaluation in mind when writing formulas. 

Now, r^Foduce the formula in cell D8 into cells P9 throu^ D12. 

To demonstrate the kind of flexibility you've now built into your 
model, move the marker to cell B4 (the overhead percentage cell), 
and change the percentage figure. Yoiu- cost column will 
automatically adjust to reflect tte new overhead figure. 
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38. PRINTING THE WORKSHEET 

If you have a printer connected to your Apple ][ computer, you 
can use it to print "hard copies" of the worksheet displayed on 
your screen. 

To print a hard copy of the worksheet: 

1. From calculate mode, type /P (for Print). 
The message: 

ENTER LOWER RIGHT OR RETURN 
will appear on the prompt line. 

2. If you wish to print the entire worksheet (which is the normal 
case), simply press RETURN, otherwise enter the lower right 
coordinate ot the rectangle of cdls ym w^h to print. You may 
also point with the marker at this cell. 

When you press RETURN, you will be placed in the Pnnt Sub- 
system. 
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1 PRINT SUBSYSTEM 




f A. STARTING CELL 

f B. ENDING CELL 

C. USE DIP PORMAT 

D. ROW ORDER POR DIP 

E. SINGLE SHEET hbhU 


A1 j 

A1 

NO 

NO 

NO 


^M_JLMAGICALC SYSTEM MENU 


2. CHANGE OPTIONS 

3. PRINT HARDCOPY 

4. PRINT SOFTCOPY 

5. PRINT IN SAVE FORMAT 

6. ENTER SETUP STRING 




I SELECT NUMBER OR LEI 1 tR, PRESS RET 


URN i 



The Print Subsystem has a menu much like that of the Pile Sub- 
system. 

Printers are conventionally connected in slot 1, but you can use 
any slot except 0. If your printer is not in slot 1, you will have to 
alter the configuration (see discussion of Configuration Sub- 
system in the Reference Gviide). 

Notice options A-STARTING CELL, and B -ENDING 
CELL. The starting cell is taken from the position of the marker 
on the worksheet when the Print Subsystem is invoked. You may 
change that now, if it is incorrect. The ending cell is set to the last 
cell containing data. 

These cells describe the upper left corner and lower right comer of 
a rectangle or block of cells. This is the area that will be sent to 
the printer. 
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If you position the marker to cell Al before typing the IP com- 
mand, you will almost always get the correct coordinates for 
these options. 

Some printers require a set of control characters to control such 
things as pitch, inter-line spacing, density of matrix, etc. Such 
setup strings will be described in your printer manual, but we wUl 
provide two examples here. 

Select option 6— ENTER SETUP STRING the same way as you 
selected items from the File Subsystem menu. 

The prompt at the bottom of your screen will change to read: 

USE CTRL— R FOR < RETURN > 

Now, let's take the Epson printer as an example. In order to print 
in condensed mode, you must issue a setup string of: 

Ctrl— O 

You may find the ASCII codes in your Apple ][ reference manual, 
or your Applesoft manual. Some printer manuals refer to the con- 
trol codes by their ASCII names— for example, Ctrl— O is also 
called SI (for shift in). In these cases, you do not send the letters S 
and I, you must look up the SI code in the ASCII chart (it has a 
decimal value of 15), then find the Ctrl key that generates that 
code. 

Once you have entered the Ctrl— O, press RETURN, and you will 
be back to the menu mode. 

Unfortunately there are very few standards in the world of 
printers. As a matter of fact, you can be assured that whftt works 
for one brand will probably not work on another. For example, 
the C. Itoh Prowriter or the Apple dot matrix printer reqmres the 
following setup string to set condensed mode: 

ESC Q 

Covering the various features of different printers is beyond the 
scope of this manual. These examples were included as examples 
to demonstrate the technique for entering a setup string. 
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In order to actually begin the printing process, select option 
3-PRINT HARDCOPY. 

The prompt: 

POSITION DOCUMENT 
THEN PRESS < RETURN > 

will appear in the middle of your screen. Make sure that the paper 
in your printer is lined up correctly, and everything is ready 
(printer on line, etc.), then press the RETURN key. 

Your Program Documentation Planning Model will begin to print 
as soon as you hit the RETURN key. 

Note: If you need to interrupt the printing operation for any 
reason (if you've made a mistake in specifying the print op- 
tions, for example), type ESC. The printer will immediately 
stop printing after the printer's buffer is empty and you 
will be returned to the Print Subsystem menu. 
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39. YOU^RE ON YOUR OWN 

By now you've learned enough about MAGICALC to begin put- 
ting it to work on your own applications. But there's still a lot 
more it can do that we haven't covered in this introductory 
tutorial. Now that you know the basics, we recommend that you 
read the Reference Guide thoroughly. There you'll find concise 
summaries of everything you've learned so far, plus information 
on all the other features not covered here. Feel free to experiment 
and try things out for yourself until you understand how they 
work. The Reference Guide or Reference Card are the places to 
look when you need to jog your memory on some detail you've 
forgotten. The range of applications you can use MAGICALC for 
is limited only by your imagination. Good luck! 
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